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Introduction 

Certainly ascembles source programs written in PDP-1 
assembly languige into object programs. The source language 
provides a convenient way of coding algorithms while giving 
the programmer complete control over the content of the 
object program. The soiirce program m&y be read from the drum 
or the on-line typewriter. The object program is written 
onto drum field 1. 

This is an abridged edition of the Certainly imnual. Many 
advanced and powerful features of the assembler are not 
described in this manual. 

Notet Sections identified with an asterisk (>^ ) nay be 
omitted on a first reading. 

Certainly processes the source program twice. During pass 
1 address tags and other symbols are defined, and constants 
and variables areas are allocated. During pass 2 the object 
program is produced. Macros, repeats, and conditionals are 
expanded during both passes. 

A sample program written in Certainly assembler langij^ge 
is shown below. 

sum 

n=100 

102/ 

a, law tab 
dap b 
dzm s 

b, lac 
adm s 
idx b 
sas c 
Jmp b 
dsm 

tab, tab+n/ 

s, 

c, lac tab+n 
start a 

The first non-blank line is the title, which is printed 
on the typewriter. The program ends with the start pseudo- 
instruction, or, if there is no start pseudo-instruction, 
with the end of the source program. 



The Source lAncuace 

For clarity, the following aymbols are assigned to the 
Invisible characters when needed in examples of parts of 
source programs. 

carriage return (cr) 
tabulation (tab) 

The source program is considered to be a series of 
syllables and separators. A separator is one of the 
following characters - space, tab, cr,- +, -, x. A, V, <, >, 
'^ , =, comma, (, ), [, ], and slash. A syllable is a string 
of alphanumeric characters (digits, letters, and period! 
preceded and followed by separators. 

The most important object in the source language is the 
expression, which has a numerical value to be used as a 
storage word of the object program, location assignment, 
argument, etc. An expression is one or more terms separated 
by suitable combining operators. The following are some of 
the forms terms can take - 

A symbol Is a syllable containing at least one letter. 
Symbols may be of arbitrary length, but are recognized 
by their first six characters. If a symbol is 
undefined, the expression in which it appears is 
undefined. If it is defined as a rracro-ins true t ion or 
pseudo-instruction, special action is taken. The 
mnemonics for the PDP-1 machine instructions are 
initially defined as shown in Appendix I. 

A number is a syllable which is a string of digits with 
an optional decimal point at the end. The value of a 
number is computed modulo 777777, except that 777777 
is not changed to 0. If a number is immediately 
followed by a decimal point, then it is taken as 
decimal regardless of the current radix. 

The syllable consisting of a single point evaluates to 
the current location, which is the address at which 
the current instruction is to be assembled. 

A term consisting of upper case characters is a micro- 
program instruction (see memo PDP-35)* The syl35.ble 
must not contain case shifts. 

A double quote (*' ) followed by an upper or lower case 
character is a term, which has the value of the 7-t)lt 
concise code of the character. The 7-bit concise code 
of a character is its concise code, plus 100 if the 
character is in upper case. 



Certain pseudo-instructions (generate terms. See the 
descriptions of the pseudo-instructions for details. 

f lexo a be is a term with value 616263 

Terms may be combined by use of the followini^ operators. 
Arithmetic Is performed in one's complement. 

+ or space means addition. A sum of zero is always plus 
zero. 

- means subtraction. Minus signs count out properly, thus 
3 = -3. -0 is not changed to +0. 

V means bitwise inclusive or 

A means bitwise and 

~ means bitwise exclusive or 

X means integer multiply. Multiplication is mod 777777. 

> means integer quotient. The argument on the left is 
divided by the argument on the right. Division by zero 
returns the origlr^l dividend. 

< means rerrainder of integer division. Division by zero 
retijirns zero. 

Operator priority 

Operations of the same priority are performed from left 
to right. Operations of different priorities are performed 
in the order given in the table below. 

unary + and - (executed first) 

< 

> 

A 
X 

V 

binary -H and - (executed last) 



Two consecutive operators arc assumed to have zero 
between them. The followln[:; arc some examples of expres- 
sions. Giving the values (in octal) on the richt, 

expression value 



2 


2 


262143. 


777777 


262144. 


1 


-0 


777777 


2+3 


5 


2-3 


777776 


2x3 


6 


400000x7 


400003 


2V3 


3 


2A3 


2 


2-^3 


1 


-5Vi 


777773 


5<3 


2 


13 >5 


2 


7-2V3 


4 


acid 40 


4 00040 


claVcma 


761200 


+Jt 


777773 


—1 


1 


3xx2 





TAZ+30 


77^032 


*x 


173 


operations on 


express io] 



An expression enclosed in brackets is a term with the 
value of the expression. Brackets may thus be used for 
grouping in order to force evaluation of parts of an 
expression in a certain order. 

2x [3+4 ] has value 16 

Wcirnini:'; - brackets are removed in a repeat range or macro 
argument list. An extra pair of brackets is sometimes needed 
to circuiwent this. 

An expression enclosed in parentheses is a term which 
evaluates to the address of the register in the next 
constants area where the expression is stored. See the 
description of constants for details. 

lio (20 ), or, as usually written, lio (20, assembles an 
instruction which places 20 in the in-out register by 
loading it from a register in the constants area In 
which 2 is stored. \ 



(>i) An expression preceded by one of the conditioml 
pseudo-Instructions ifp, ifm, ifz, Ifn, or if up, and 
followed by a sJash, is a term with value 1 or depending 
on the result of a test applied to the expression. See the 
description of these pseudo-instructions for details, 

if up 2/ has value 1 if sense switch 2 is up, zero 
otherwise. 

ifz a/Alfp b-i2A3 has value 4 if a is zero and b-+2 is 
positive, and 3 otherwise. 

Note that the bitwise and, or and exclusive or operators 
nay be used as logical operators with logical values and 
1. 

Grouping brackets, constants, and conditior&ls nay be 
nested to any reasomble depth. 

The closing parenthesis, closing bracket, or slash that 
ends the expression within a constant, conditional, or 
grouping; brackets nmy be omitted. The assembler will assume 
that the missing character was pi^iced in the last position 
that will result in a syntactically correct expression, 

examples - lio (20 

The assembler assumes a right paren 
just before the cr. 

repeat ifz a,foo 
The assembler assumes a slash before the comma. 
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Uses of Expressions 

The meaning of an expression to Certainly is determined 
by the context in which it appears in the source program. 
The character immediately following the expression usually 
Indicates its use* 

Storage word 

An expression terminated by a cr or tab is a storage word 
and is assembled into the object program, 

examples - jmp ret 
lac a be 

The 18 bit number which is the value of the expression is 
assigned a location in memory determined by the location 
counter in the assembler. After each word is stored, the 
location counter is advanced by one* A storage word may be 
an instruction, a constant, or data. A tab or cr not 
preceded by an expression, or preceded by arithmetic opera- 
tors only, with no syllables, does nothing. If a storage 
word is undefined on pass 2, the usw error message will be 
given. 

Location assignment 

An expression terminated by a slash is a location 
assignment. The current location is set to the value of the 
expression truncated to twelve bits. 

example - 100/ sza 

Jmp 100 

The above source program part will cause the instructions 
sza and Jmp 100 to be assembled into locations 100 and lOi 
df the object program, respectively. 

An undefined location assignment will give the usl error 
message. 



A ddrcss tag 

An expression followed by a comma Is an address tag. if 
the tag Is a single undefined symbol, that symbol will be 
defined to be equal to the current location. If it is a 
defined expression, it is compared with the current loca- 
tion, and a disagreement will cause an mdt error message to 
be printed. (Use of the same symbol as an address tag twice 
in one program is a common cause of this error.) If the tag 
is undefined but more complicated than a single symbol, it 
is ignored on pass 1 and a ust error is given on pass 2, 

example - a, dzm i tab+n 

sxxz 

jmp a 

When the assembler defines a symbol as an address tag, if 
the comma is preceded by a centerdot, the symbol is defined 
in such a way that it will not be transmitted to ID. 

Note the opposite character of location assignments and 
address tags. A location assignment moves the value of an 
expression into the location counter, while a tag moves the 
location counter Into the symbol which forms the tag. 

A sequence such as tab, 

tab+n/ 

is frequently used to reserve a block of registers for a 
table of data, in the above example, the length of the block 
is n, and tab is defined as the address of the first 
register in the block. 



U) Poriml symbol definition 



A symbol followed by an equals sign and an expression is 
defined to have the value of the expression if the expres- 
?« ?oi:^ defined. If the expression Is not defined, no action 
JLS taicen on pass 1, and the use error is given on pass 2. A 
formal symbol definition overrides any previous definition 
or the symbol, whether it was a numeric definition, an 
instruction mnemonic, a pseudo-Instruction, or nacro. If an 
under bar precedes the equals sign, the symbol will be 
defined in such a way that it will not be transmitted to ID, 

examples - n=slOO 
t=t+t 
sml=spi 1 

No storage word is generated by a formal symbol definition. 
Comments 

A slash, when not preceded by an expression, begins a 
comment. All characters are Ignored up to the next carriage 
return. 



The location coimter 

The location counter records the address at which the 
current storage word is to be assembled. It is set to zero 
at the beginning of each pass and is advanced by one after 
each storage word Is assembled. Any attempt to assemble a 
word, constant, or variable into location lOOOO will produce 
an rpm error. 



example - 



dzm 1 tab+n 

sxxz 

Jmp .-2 



assembles Into the same sequence of instructions as the 
example given in the section on address tags. 
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Pseudo-Instructions 

bler^^^^hri^r""""""?? ^""^ special comnands to the assem- 
mt^' . f^ ^?! usually used for eeneratlnK certain types of 
c&ta, controlling the assembly process, and defining mc^of^ 

m,»^\^ Certainly acts on a pseudo-instruction when- 

ever it encounters its name followed by any separator other 

Sja? °^;^'mo"l^?;a ^T °'v,'^'^ ciescriptlons^ri^'llve Tms 

^c^nl^od hv thPli:: ?i^o.°''^^^°^S''^ ^°"E- Sl"°e symbols are 
recQcnizod oy their first six characters only, any pseudo- 

Inatruction name nay be shortened to six characters ?f or 
example, churac instead of character). They my not te 
Shortened further except for chamcter and flL^^f or whl^ 
Smbol taWe! "^"^^ ""^'^ """"^ ^^^^ ^'•^ "^^^^"^^ ^" the initial 

Data Generating Pseudo-Instructions 
character and char 

^hai^'^^io^°'^^?"^"^^^"°'^^°" character (or its abbreviated form 
oori^ rL'^^ ^? Generate a syllable containing the concise 

instruction ls^n?!^ou,°fr°^^^' '^^^ "^"^ °^ the pseudo- 
ri n^^ h fu ^°3^0"ed by a separator, the letter 1, m, or 
r, and then the character to be translated. The letter 1 m 

oLLf '?^'^"^% f ^^^^-^^ t^« following Character is to' b4 
placed In the loft, middle, or rlrht six bltr> or ^ho uir,v.^ 

cha^°cter"?;i^:L°,°''fj: '^'^'"' ^■^^----^ot'"ti\tLT\ri^i 

Character following the separator is not 1. m. or r thaf 
S'?tr°'^<^^v,-^\'°"' ^" '^'"'' ^"'^ ^= placed in the ?ight sl^ 
within a^'exi^essfon!""''' '^ character nay be used anywhere 

examples - char ra = 0OOO6I 

char mb = 006200 

char Ic = 630000 

char d = 000064 

f lexo and flex 

f^Tov^"" pseudo-Instruction flexo (or Its abbreviated form 
thllL r.v:U^t'^ to pack three characters into one word. The 
three characters immediately following the sepamtor after 
the pseudo-instruction name are packed from left to rlrrht 
'me resulting term may be used ^here w??hln an J^esl 

example - f loxo a be = 616^63 

this is equivalent to char laVchar mbVchar re 



text 

The pseudo-Ins truction text Is used to assemble an 
arbitrarily long strln^^, of characters. The character immedi- 
ately following the separator after the pseudo-instruction 
r&me is used as the break character. Following characters, 
up to but not including the next appearance of the break 
<55}Q;3^oter, are packed three to a word and assembled into the 
object program, if the break character which ends the string 
is followed by octal digits instead of a separator, the 
assembler goes into '*octal** mode, in which pairs of digits 
are taken as 6 bit numbers and packed as if they were 
characters. When the break character is next encountered the 
assembler reverts to normal •*text' mode. The assembler 
alternates between text and octal modes until the break 
character, followed by a separator, is found while in text 
mode. Note that the string begins and ends in text mode, and 
there are always an even number of appearances of the break 
character. 

examples - text .abc.7652.de. assembles into 

61626: 



76326 
650000 

text //14/abc/l3// assembles into 

146162 
631300 

Because text may generate more than one word of data, it 
should only be used to generate storage words. It should not 
be used in constants, arguments, etc. 

{>{) text7 

The pseudo-instruction text7 assembles characters in 7- 
bit form. The pseudo-instruction name is followed by a 
string in the same format as for text. The 7-bit concise 
codeti of the characters are packed five per two words, left 
Justified. Bit.O of the first word in each pair is zero. In 
octal'* mode, three digits are used for each character. 

exa mp le - t ex 1 7 /Wha t ? ?/ 
assembles into 
octal bir&ry 

254703 lOlOllO 0111000 Oil 
044721 0001 0010011 lOlOOOl 
242000 1010001 0000000000 
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(>t) ifp, ifm, ;Lfz, and ifn 

These four pseudo-instructions apply a test to a numeric 
argument and generate one or zero dependlnc on the result. 
Ifp, ifm, ifz, and ifn generate 1 M and only If the 
argument is positive, negative, zero, and nonzero, respec- 
tively. For the purposes of the test, +0 is positive and 
zero, and 777777 (-0) is negative and nonzero. The expres- 
sion to be tested follows the sepai^itor after the pseudo- 
instruction name and is ended by the next unpaired slash 
(see the section on syntax), if the expression under test is 
undefined during pass 1, the term generated by the pseudo- 
instruction is undefined. If the expression under test is 
undefined during pass 2, the usi error is given instead. 

(A) if up 

The pseudo-instruction ifup is used to test a sense 
switch at assembly time. The expression following the 
separator after ifup and ended by the next unpaired slash is 
taken to be the number of the switch. A value of 1 is 
generated if that switch is up, zero if down. 
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Radix Control 

All numbers not followed by a dec lira 1 point are inter- 
preted according; to the current radix. At the beginning of 
each piiss, the radix is set to octal. 

decimal 

Decimal sets the radix to decimal. 

octal 

Octal sets the radix to octal. These pseudo- instruct ions 
may be used anywhere within an expression, hence an expres- 
sion may be interpreted partly in decimal and partly In 
octal. 

(>{) radix 

Radix is followed by an expression and sets the radix to 
the value of that expression. The expression must be defined 
on both passes. The usx error is given if this is not the 
case. 
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AutoiTBLtic Constant Allocation 

It is frequently necessary to assemble an Instruction 
whose address part is the address of a register in which a 
constant is stored. The assembler facilitates this operation 
by automatically assembling a register containing a constant 
whenever the constant appears enclosed in parentheses in an 
expression. The constant with its parentheses then evaluates 
to the address in which the constant is assembled. The right 
parenthesis after the constant nay be (and almost always is) 
omitted. A constant does not need to be defined on pass 1. 
If it is undefined on pass 2 the use error will be given. 

example - sas (13 

assembles into an instruction which DPclps if 
the accumulator contains 13 

constants 

The actual constants are saved in a table in the 
assembler and then assembled in a block at the next 
appearance of the constants pseudo-instruction. Duplicated 
constants arc combined and stored in the same register. The 
amount of space allocated for the constants area during pass 
1 may exceed the amount actually used on pass 2, since, if 
constants are undefined on pass 1 the assembler is sometimes 
unable to determine whether they are duplicated and must 
assume that they are not. 

The pseudo- Instruct ion constants may be used up to 8 
times in a program. Each constant is placed in the next 
constants area regardless of v/hether the same constant 
appeared In an earlier constants area. The prograranier should 
not make any assumptions about the order of constants within 
a constants area. 



Autonntlc Variable and Array Allocation 

Certainly will autonatically allocate one register of 
msmory for a variable or temporary if the name of the 
variable appears with an over bar. The overbar may be 
anywhere within the name. Only one appearance of the name 
needs an overbar. The symbol will be defined to have a value 
of the address of the rep/ister which is allocated. A 
variable must have been previously undefined on pass i. The 
radv error will occur if this is not the case. 

d'lmension 

The dimension pseudo-instruction declares a symbol as an 
array or table to be automatically allocated. Dimension is 
followed by a series of array declarations separated by 
Gornnas and terminated by a carriage return. Each declaration 
consists of the array name optionally followed by its length 
enclosed in parentheses. If the length specification is 
absent, the length is assumed to be i. The length may be any 
expression, which must be defined on pass 1. The usd error 
will occur if the array size is not defined. Each array name 
will be defined as the value of the address of the first 
word of the array. An array name must have been previously 
undefined on pass 1. The mdd error will occur if this is not 
the case. 

example - dimension a(lo),b(20),c (1 ),d 

declares a, b, c, and d as arrays of 10, 20, 1, and 1 
words respectively. The declarations for c and d 
could have been accomplished by their appearance 
with an overbar in any expression. 

variables 

All variables and arrays are placed In a variaoies area, 
which the assembler constructs when it encounters the 

variables Dseudo-instruction. This pseudo- instruct ion may be 
used up to 8 times in a program. Each variable or array is 
placed in the next variables area after the overbar or 
dimension pseudo-instruction that declares it. The program- 
mer should not make any assumptions about the order of 
variables and arrays within an area. The initial contents of 
variables and arrays are not assigned by the assembler. 
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The ur>e of dimension, constants, and variables is shown 
in the proeram below. 



sum 

n=100 

dimension tab(n) 

ioe/ 



a. 


law tab 




dap j2 




dzm s 


b, 


lac 




adm s 




Idx b 




sas (lac 




Jmp b 




dsm 


variables 




constants 




start a 





tab+n 



Ihls will produce the same object program as the example 
given In the introduction, except that s is not initialized, 
and the relative order of s and tab in the variables area is 
unknown. The array tab is not initialized in either example. 
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(>i) repeat 

The pseudo-instruction repeat Is used to imke the assem- 
bler process part of the source program a specified number 
of times. The pseudo-instruction is followed by the count, 
which may be any expression and is terminated by a comna. 
Ihe characters following the comma up to and including the 
next carriage return are the range. The assembler behaves 
exactly as if the range had been typed a number of times 
equal to the count. 



example - repeat 3,ril 6s 

is treated as if it were 
rll 6s ivk 300 

rll 6s ivk 300 

rll 6s ivk 300 

another example 



ivk 300 



z=o 






repeat 3 


,z=z+10 


y=0 repeat \ 


is treated 


as if it 


were 


z=() 






Zs=«+10 


y-0 


repeat 3,y=y+l 


Zs:2+l0 


y=o 


repeat 3,y=y+l 


Z=^-flO 


y=o 


repeat 3,y=y+l 


which is treated as 


if it were 


z=0 






z=z+10 


y=o 


y=y+l y+z 


y=-y+l 


y-Hz 




y=y+l 


y+z 




z=z+10 


y=0 


y=y+l y+z 


y=y+l 


y+z 




y=y+i 


y+z 




z=^+io 


y=o 


y=y+l y+z 


y=y+i 


y+z 




y=y+i 


y-Hz 





y+z 



y+z 
y-Kz 
y+z 



which assembles into the sequence of words 
11,1^, 13 ,21 ,22 ,23 ,31 ,32 ,33 

ITie count must be definite on both passes, or the usr error 
will occur, A negative count is taken as zero. 



\€ 



The repeat range ends on the first carriage return not 
contained within brackets. These brackets are not to be 
confused with the brackets used for arithmetic grouping. 
Ihey serve only to '^hide" carriage returns and prevent them 
from ending the repeat range. The brackets are removed, that 
is, the assembler behaves as if the range without the 
brackets had been typed the specified number of times. If a 
bracket is immediately preceded by an upper case shift and 
followed by a lower case shirt, both case shifts are removed 
also. In order to permit brackets to appear within the 
range, only the outermost pair is removed. Where repeats are 
nested, one pair is removed at each level. Thus, in order to 
place the arithmetic expression 3x[4+5] within three levels 
of repeats, three extra pairs of brackets must be used even 
when there are no carriage returns to hide. 

repeat 1, [repeat 1, [repeat 1, [3x[4+5 ] ]] ] 

becomes 
repeat 1, [repeat l,[3xW+5]]] 

which becomes 
repeat 1, [3x[4+5]] 

which becomes 
3x[4+5] 
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(>{ ) r^c ro-ins true t Ions 

A rracro-lnstruction is a user-defined "abbreviation'* for 
a given string of characters. Micro-instructions are created 
by use of the define and terminate pseudo-instructions. 
Subsequent appearances of the macro-instruction name cause 
the macro to be "called". The assembler behaves exactly as 
If the characters that form the definition had been typed in 
place of the call. A macro- instruct ion call rr&y supply 
arguments that are inserted into the definition at specified 
points. The characters that are substituted for the call are 
the dx: pans ion" of the macro. Macro-lnst ructions must be 
defined before they are called. 

example with no arguments 

(definition) define a bo 

spa 
cma 
terminate 

(call) lac X 

abs 
dac y 

is treated as if it were 

lac X 

spa 
cma 
dac y 

example with two arguments 

(definition) define move a,b 

llo a 
dio b 
terminate 

(call) move J,k-f3 

is treated as if it were 

llo J 
dio k+3 
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another 

(definition) define clear a,b 

3AW a 
dap ,+1 

dzm 

Idx .-1 
sas (dzm a+b 
jmp • -3 
terminate 

(call) clear tab, 100 

is treated as if it were 



law 


tab 




dap 


.+1 




dzm 






idx 


.-1 




sas 


(dzm 


tab+100 


Jmp 


• -3 




termimte 







define and 

The pseudo- instruct ion define is followed by the name of 
the imcro to be defined and then the list of "'dummy- 
symbols'*, separated by commas and terminated by a carriage 
return. The following text, up to the appearance of the 
pseudo- instruct ion terminate, become the definition. All 
appearances of dunmy symbols within the definition are 
removed and marked as places where arguments are to be 
substituted when the macro is called. The actml definition 
begins with the character after the tab or carriage return 
that ends the durmiy symbol list. It ends on and includes the 
separator before the terminate pseudo-instruction. In order 
to permit macro definitions within a macro, appearances of 
define and terminate are counted. The macro ends on the 
first terminate not paired with a define. If terminate is 
followed by a separator other than tab or carriage return, a 
symbol must follow. It is compared with the name of the 
n&cro being defined. A disagreement causes the mnd error. 
Ihis is sometimes helpful in debugging complicated rracros. 



In order for the assembler to recocnlze a dummy symbol in 
the definition, the symbol must be preceded and followed by 
separators or non-alphanumeric characters such as overbar, 
underbar, conterdot, or illegal characters. In some cases it 
is desirable to substitute an argument ad.Jacent to an 
alphanumeric character, such as a symbol. This would require 
adjoining a dummy symbol with another symbol, which nakes It 
Impossible for the assembler to determine where one symbol 
ends and the other begins. To prevent this difficulty, the 
separator single quote is provided. A single quote separates 
the symbols, permitting recognition of the durrmy symbol. The 
single quote is then removed and does not appear in the 
expansion. If it is immediately surrounded by case shifts, 
they arc removed also. 

example - define type x 

law char r*x 
ivk 100 
terminate 

type q then becomes 

law char rq 
ivk 100 

Ihe use of rx without the single quote would have prevented 
recognition of x. Where the count of defines is nonzero, 
i.e. in a definition within a macro, single quotes are not 
removed, since they will presumably be needed again. 

imcro calls 

A rracro is called whenever its name appears followed by a 
separator other than equals sign. If the separator is tab or 
carriage return, there are no arguments. Otherwise the 
follow Ini': characters, up to the next tab or carriage return, 
form til e argument list. The arguments are separated from 
each other by commas. They do not include the commas, the 
separator after the macro name, or the tab or carriage 
return after the last argument. In order to permit comna, 
tab, and carriage return in an argument, these characters 
imy be hidden inside brackets in the same way that carriage 
returns are hidden in a repeat range. The outermost pair of 
brackets is removed from each argument. The arguments are 
then substituted as character strings for the dunrny symbols 
in the definition, and the resulting expansion is substi- 
tuted for the macro call. After the expansion has been 
processed, assembly resumes with the character after the tab 
or carriage return that ended the argument list. 



If more areumentn arc Gupplied than the number of dumn^ 
aymbols in the definition, the extra arguments are ienored. 
If too few arcuirients are supplied, the empty character 
string is used for the missing arguments, unless a symbol is 
generated, 

generated symbols 

It is sometimes helpful to have a nacro gener^tte one or 
more symbols to be used as address tags, etc. within the 
macro. For this purpose dummy symbols may be declared to be 
candidates for generated symbols. If a slash appears in the 
duntny symbol list, all the following symbols are candidates 
for symbol generation. If, at the time the macro is called, 
the argument corresponding to such a symbol is missing, the 
assembler will generate a symbol and use it for the 

argument. A new symbol Is enerated for each call. Generated 
symbols are of the form .gOOOl, .g0002, etc. If the argument 
is supplied, it overrides the generated symbol. 

example - define ifzero x/y 
sza 
Jmp y 

X 

terminate 

The generated symbol provides an address for the instruction 
to Jump over x without knowing hew many words x will become. 

Ifzero [lac a 
dac b 
lio c ] 

becomes 

sza 

jimp .gOOOl 
lac a 
dac b 
lio c 



•gOOOl, 



stop 



The pfjcudo-instruction stop causes an immediate exit from 
the most recently entered macro. The assembler behaves as if 
it had reached the last character of the definition, and 
continues from the character after the call. 
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Miscellaneous Pseudo-instructions 
start 

The start pseudo-instruction indicates the end of the 
source program. It is optionally followed by an expression 
to be used as the starting address for the program. If 
Certainly was started at location ice (as by V from 
Expensive Typewriter), the starting address is placed in the 
program counter when control is returned to ID, 
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Program Format 

While Certainly has few requirements on format, many 
programmers have found that adherence to a fairly rleld 
format is helpful in writing; and correctlnc programs. The 
follcwlng suggestions have been found useful in this 
respect. 

Place address tags at the left margin, and run instruc- 
tions vertically down the page Indented one tab stop 

from the left margin. 

Use only a single carriage return between instructions, 
except where there is a logical break in the flow of 
the program. Then put in an extra carriage return. 

Forget that you ever learned to count higher than five. 
Let Certainly count for you. Do not write "dac .+16**, 
use an address tag. This will save grief when 
corrections are required. 

Have a listing handy when assembling or debugging a 
program. Carefully note corrections thereon as soon as 
they are found so as to maintain an up-to-date 
listing. 

As macro- instruct ions must be defined before they are 
used, put these definitions at the beginning of the 
program. 

If the pseudo-instructions variables and . constants are 
used, place them at the end of the program, just 
before start. 
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Assembly Procedure 

Certainly norrnally reads the source program from Expen- 
sive Typewriter' s text buffer and places the object program 
on drum field 1. Hew ever, many variations in procedure are 
possible by typing control characters on the typewriter. 

When Certainly is started at location ice (as it is when 
the '*n"' command is given in Expensive Typewriter), it 
automatically goes through both passes of the assembly and 
returns to ID as if the sequence z, s, s, and b had been 
typed. It directs ID to place the starting address of the 
program in the program counter, read the symbol table, and 
unsave drum field 1 (which contains the object program) into 
core. 

When Certainly is started at location 104 (as it is when 
the "m"* command Is given in Expensive Typewriter), It 
listens for control characters from the typewriter. After 
each pass on a program section. It listens for more control 
characters. 

Whenever sense switch 1 is up. Certainly types out every 
character of the source program. Including expansions of 
repeats and macros. This is useful when debugging macros. 
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Control ChMractoru 

input medium 

e Expensive Typewriter text buffer 

y online typewriter 

output medium 

d drum field 1 

w without output (just check for errors) 

assembly control 

s begin next pass 

f forget (initialize everything) 

z assign and zero drum field 1 

k print constants and variables areas 



exit 



b back to ID, leaving symbol table in core where 

"2t" command can read it 

m meliorate source program (back to Expensive 

Typewriter) 



Error Messages 

^,- ^l^°P. detecting an error. Certainly will print a line in 
the following f ornat. 

aaa p,l c d e 

Where aaa is a three letter code indicating the error, p,l 
is the page and line numbers at which the error occurred (if 
input is from Expensive Typewriter text buffer), c is the 
symbolic address (relative to the last tagj, and d is the 
ne-me of the last pseudo-instruction or macro. In the case of 
an error caused by a symbol, e is the symbol. Following is a 
list of error messages and the action taken if assembly is 
continued. 

see Symbol table capacity exceeded. No recovery. 

pee Pushdown capacity exceeded (nesting of repeats 

and macros is too deep). The pushdown list 
is cleared and assembly starts over at the 
top level. 

cce Constants capacity exceeded (more than about 4 00 

constants;. The current constant will evaluate to 
zero. 

mce Macro capacity exceeded and the garbage collector 

could recover no space. No recovery. 

ich Illegal character. It is i(5nored. . 

rpm Wrap around memory. The location counter has 

exceeded 7777. It will be reset to zero. 

ilf Illegal format. Characters are ignored to the next 

tab or carriage return. 

ipi Illegal pseudo-instruction. A pseudo-instruction is 

used in an illegal context. Same recovery as ilf. 

mdv Multiple definition of a variable (a symbol with an 

overbar was previously defined). The old 
definition remains. 

mdd Multiple definition in dimension (a symbol in a 

dimension declaration was previously defined). 
The old definition remains. 

mdt Multiple definition of a tag. A defined tag does 

not match the location counter. The tag is 
not redefined. 



usv; Undefined symbol In a storage word. The symbol is 

taken as zero. All error messages beginning with 

us refer to undefined symbols and are 
identified by the third letter as follows! 

usl In a location assignment. 

UGC In a constant. 

usi In a conditional (if). 

uss In argument for start. 

ust In an address tag that is not a single symbol. 

usr In a repeat count. 

usd In an array size for dimension. 

use In a formal symbol definition (with eqi^ls sign). 

USX In an argument for radix, 

nca No constants area. The constant ui asaembled ac. zero. 

lr>'^ Illegal formal symbol assignment. It is ignored. 
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mere name disagrees with n^imc after termlncite 
The original nfime Is used. 



uer Micro-program error (upper case letters do not form a 

micro-program instruction). Same recovery as ilf . 

vld Variables location disagrees between passes 1 and 

2. The location is forced to agree. 

tmv Too many variables areas. The pseudo-instruction 

variables is ignored. 

eld Constants location disagrees between passes 1 and 

2, The location is forced to agree. 

tmc Too many constants areas. The pseudo-instruction 

constants is ignored. 

ctl Constants area too long (longer on pass 2 than on 

pass 1). The constants area is truncated. 

eot End of text reached in improper context (e.g., in 

the middle of a macro definition). The current 
pass is ended. 
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Machine Instructions 

Is 1 

2s 3 

3s 7 

4s 17 

5s 37 

6s 77 

7s 177 

8s 377 

9s 777 

I 10000 
and 20000 
lor 40000 
xor 60000 
xct 100000 
Ijcr 120000 
Jdp 140000 
oal 160000 
Jda 170000 
3a c 200000 

II o 220000 
(ixc 240000 
d^P 260000 
dip 300000 
dlo 320000 
dzm 340000 
adm 360000 
add 400000 
sub 42 0000 
Idx 440000 
Isp 460000 
sad 500000 
sas 520000 
mul 340000 
dlv 560000 
Jmp 600000 
Jsp 62 0000 
skp 640000 
szf 640000 
szs 640000 
sza 640100 
spa 640200 
sma 64o4oo 
szm 640500 
szo 641000 
spi 642000 
sni 644000 
spq 650500 
clo 65I6OO 
sft 660000 
ral 661000 
rll 662000 



Appomllx I 
Initial :jymbola 
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rcJ 603 000 

sal 661; 000 

sil 666000 

scl 667000 

rar 67IOOO 

rir 672000 

rcr 673000 

sar 675000 

sir 676000 

scr 677000 

law 700000 

}an 707777 

lot 720000 

tyl '"/2 0004 

ckn 720027 

ckG 7^0033 

dsc 720050 

asc 71^0051 

oric 7^0053 

l£jm 720054 

esm 720055 

cbs 7^^0056 

dra 72 0063 

rbt 720237 

vat 722477 

sdl '■/^3477 

lei 724577 

lea 724677 

rer 724777 

tyo 730003 

dpy 730007 

Ivk 740000 

opr 7GOOOO 

nop 760000 

elf 760000 

Gtf 760010 

11a 760020 

lai 76 004 

swp 760060 

cml 76 01 00 

cla 760200 

cma 761 000 

clc 76I200 

3a t 7622 00 

ell 764000 

lolc 7700^m 

ulk 770cyil 

frk: 770042 

qlt 770043 

bpt 770(yM+ 

eem 7700^t6 

lem 770047 

rpf 770050 

Ipf 770051 

mm 770052 

bam 770053 



.l.am 


770054 


dam 


770053 


aam 


770056 


e^m 


770060 


elm 


77006I 


mta 


770070 


hit 


770074 


dsm 


770077 


Pseudo-. 


Instructions 


cc oun7 




ccount 




char 




charac 




consta 




dec ima 1 




define 




dimenn 




eq\-altj 




flex 




flexo 




functl 




if2 




n\i 




:irm 




:irn 




ITp 




if sym 




:lf up 




ITz 




Irp 




-lrp3 




Irpinf 




noinpu 




octal 




offset 




ones 




prlntc 




printo 




prlntx 




ra d Ix 




road In 




repeat 




return 




Gpcll 




o4 UOii c.^ 




start 




stop 




termln 




text 




text7 




twos 




varlab 




word 
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Appendix II - Concise Codes 



Character 


Concise Code 


a A 


61 




b B 


62 




c C 


63 




d D 


64 




e E 


63 




f F 


66 




S G 


67 




h H 


70 




1 I 


71 

41 




J J 




k K 


42 




1 L 


43 




m M 


44 




n N 


45 







46 




p P 


§2 




r R 


31 




s S 


22 




t T 


23 




u U 


24 




V V 


23 




w W 


26 




X X 


27 




y Y 


30 




z Z 


31 




-► 


20 




1 " 


01 




2 « 


02 




To 


03 




5 V 


03 




6 A 


06 




v> 


11 




9 t 


11 




n 


57 

33 




— 


36 




- + 


34 




• 




40 


> = 


33 




• X 


73 




/ ? 


21 




downshift 


72 


upshift 


74 


space 


00 


backspace 


11 


tab 




carriage return 77 


black shift 


34 


red 


Shift 


33 


stop code 


13 



